home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr41 / smrtcd20.zip / SMARTCD.DOC next >
Text File  |  1995-02-02  |  15KB  |  320 lines
  1. ******************************************************************************
  2. **                    SMART! CD Audio Player -- ver 2.0                     **
  3. **                    "Programmable Even While Playing"                     **
  4. **                    by Henrique Avila Vianna - Aug/93                     **
  5. ******************************************************************************
  6.  
  7.    Featuring:
  8.  
  9.    * Know what you are listening to: informs you disc and track titles!
  10.    * Programming up to 32 tracks.
  11.    * Add and remove tracks from the program, even during playback!
  12.    * Shuffle function: random programming, with no track repetition.
  13.    * 2-level Repeat function: repeat one track or the whole disc/program.
  14.    * Beautiful VGA semi-graphical display.
  15.    * TSR routine: plays the CD while you work!
  16.  
  17. Contents
  18. --------
  19.  
  20.    1. Introduction
  21.    2. Hardware and software requirements
  22.    3. How to use SMART! CD
  23.    4. Known problems
  24.    5. Disclaimer
  25.    6. Distribution policy
  26.    7. SMART! CD history
  27.    8. Other programs by the author
  28.    9. Contacting the author
  29.  
  30.  
  31. 1. Introduction
  32. ---------------
  33.  
  34.    I wonder if the guys that created the CD never thought of storing the
  35. disc and tracks titles on the disc, so we could see on the player's display
  36. what we are listening to (what is specially useful when you own a 6-disc
  37. player like I do!)
  38.  
  39.    That was my main objective when I began to write this program. SMART! CD
  40. is a TSR (Terminate and Stay Resident) program that simulates a regular
  41. CD player equipment, with some extended features. The program lets you type
  42. in the disc and tracks titles and then saves this information to your hard
  43. (or floppy) disk, so it can be restored the next time you use that CD.
  44.  
  45.    SMART! CD supports track programming up to 32 tracks, and has also a
  46. Shuffle function that will play all the tracks (up to the limit of 32) in a
  47. random order, without repetition. Tracks can be added and deleted from the
  48. program even when the CD is already playing! The Repeat function has two
  49. levels: repeat the current track, or the entire disc/program.
  50.  
  51.    The program uses redefined VGA characters to create a LED-like display
  52. and the TSR routine lets you activate the program while you are working in
  53. another application.
  54.  
  55. 2. Hardware and software requirements
  56. -------------------------------------
  57.  
  58.    These are the minimum requirements in order to use SMART! CD:
  59.  
  60.    * IBM PC-XT or better
  61.    * CD-ROM drive (no kidding!)
  62.    * VGA graphic card (a video monitor with a good dot pitch is also
  63.      recommended -- I use really small letters there!)
  64.  
  65.    * MSCDEX 2.1 or later
  66.    * MS-DOS 3.1 or later
  67.    * 35 Kbytes of free memory (amount used by the program while resident)
  68.  
  69.  
  70. 3. How to use SMART! CD
  71. -----------------------
  72.  
  73.    The first thing to do is install your CD-ROM device driver (what must be
  74. done somewhere in your CONFIG.SYS file) and run the MSCDEX program (Microsoft
  75. CD Extensions).
  76.  
  77.    To install SMART! CD simply type SMARTCD in the DOS prompt. The program
  78. will stay resident in the memory; to remove it you must run it again with
  79. the /R (remove) option. SMART! CD uses about 35 Kbytes of memory and it can
  80. be loaded in the Upper Memory Area.
  81.  
  82.    After the program is installed, you should press CTRL and ENTER keys to
  83. activate and use it. Please note that the program will only be activated in
  84. the 80x25 text mode. When you call the program it will be displayed in a
  85. window over your foreground application; when you exit it the foreground
  86. screen is restored. Below is a representation of the program's window:
  87.  
  88.    XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  89.    XXXX This is the disc title                        XXXX
  90.    XXXX                                               XXXX  <--- Main
  91.    XXXX 01  00:00 >> 05:32                  14  64:08 XXXX       display
  92.    XXXX Here comes the song title                     XXXX
  93.    XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  94.    XXXX  >||  []  >| |<  PRG  DEL  RPT  SHF  DSC  SNG XXXX  <--- Control panel
  95.    XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  96.    XXXX                                               XXXX  <--- Programmed
  97.    XXXX                                               XXXX       tracks display
  98.    XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  99.  
  100.    The first line shows the disc title; under it there is the track and disc
  101. information, from left: the current track number, the current track playing
  102. time, the current track total time, the total number of tracks on the disc
  103. and the disc total playing time. In this line, there are also light indicators
  104. (that couldn't be drawn in this text screen) that show the repeat and program
  105. status. The last line of the main display is used to show the current track
  106. title. Under the control panel there is a smaller display that is used to show
  107. the programmed tracks (up to 32).
  108.  
  109.    Keys used to control SMART! CD:
  110.  
  111.    Key     Function    Action
  112.    --------------------------------------------------------------------------
  113.    ESC     EXIT        Return to the DOS prompt or foreground application
  114.    F1      PLAY/PAUSE  Start playing the current track or the program;
  115.                        pause and resume the playback
  116.    F2      STOP/CLEAR  Stop the playback (pressed twice clears the program)
  117.    F3      PREVIOUS    Skip to the previous track in the disc or the program
  118.    Shf+F3  PREVIOUS    Select the previous track when the program is playing
  119.    F4      NEXT        Skip to the next track in the disc or the program
  120.    Shf+F4  NEXT        Select the next track when the program is playing
  121.    F5      PROGRAM     Add the current displayed track to the program
  122.    F6      DELETE      Delete the last track of the program
  123.    F7      REPEAT      Change the repeat function status (track/all/off)
  124.    F8      SHUFFLE     Start playing a random program
  125.    F9      DISC TITLE  Edit the disc title
  126.    F10     SONG TITLE  Edit the song title
  127.  
  128.  
  129.    I think you'll have no problems using the most common functions, so let's
  130. take a look at the enhanced features:
  131.  
  132.    PROGRAMMING TRACKS
  133.    ------------------
  134.  
  135.    To create a program or to include new tracks in the current program
  136. select the track using the F3 (previous) and F4 (next) keys. When the desired
  137. track is displayed, press F5 (program). To delete tracks from the program
  138. use the F6 (delete) key; each time you press it, the last programmed track
  139. is removed. Press F1 (play) to start playing the programmed tracks.
  140.  
  141.    If want to include new tracks in the program after you started playing it,
  142. you should use SHIFT+F3 (previous) and SHIFT+F4 (next) to select the desired
  143. track. As you use these keys, the current selected track is shown ("lit off")
  144. at the next position of the program display; pressing F6 the track is added
  145. to the program.
  146.  
  147.    When the program is active (the "PROG" indicator is lit), "# of trks" and
  148. "disc time" will be showing the number of tracks and the total playing time
  149. of the program.
  150.  
  151.    To stop playing the program, press F2 (stop/clear); if you press it again
  152. the program is cleared.
  153.  
  154.  
  155.    THE REPEAT FUNCTION
  156.    -------------------
  157.  
  158.    You can use the Repeat function to repeat either the track that is currently
  159. being played or the entire disc or program. Press the F7 key once and you'll
  160. notice a circular arrow indicator lights on at the main display; this indicates
  161. that the current track will be repeated. If you press F7 again the "ALL"
  162. indicator lights on and the entire disc or program will be repeated when it
  163. finishes. Pressing F7 once more, both indicators will light off and the
  164. Repeat function will be deactivated.
  165.  
  166.    While the Repeat function is active you are still able to use the Previous
  167. and Next track commands; if the repeat is at track level, the current track
  168. will be repeated indefinitely, until you skip to another track or disable the
  169. Repeat function.
  170.  
  171.  
  172.    THE SHUFFLE FUNCTION
  173.    --------------------
  174.  
  175.    The Shuffle function creates a random program with all the tracks and
  176. automatically starts playing it. You can add and delete tracks from this
  177. program normally. The Shuffle function can only be activated when the CD is
  178. stopped.
  179.  
  180.  
  181.    EDITING DISC AND SONG TITLES
  182.    ----------------------------
  183.  
  184.    The disc title appears on the first line of the player's display in red
  185. letters. To enter the of the CD, or to edit the current one, press F9. The
  186. cursor will appear at the leftmost position of the display and you can type
  187. in the desired text (up to a limit of 47 characters).
  188.  
  189.    The song (track) title appears on the last line of the main display and
  190. shows the title of the currently displayed track. So, in order to enter all
  191. the tracks names, you should edit the current track title, skip to the next
  192. track and so on. Press the F10 key to edit the track title.
  193.  
  194.    You can enter a disc or track title while the CD is playing (though the
  195. time display will be freezed while editing) so I personally suggest you to
  196. type the names as the disc plays (it's less boring).
  197.  
  198.    You can use the arrow keys, Home, End, Insert, Delete and Backspace keys
  199. when editing.
  200.  
  201.    The disc info is saved in the same directory where SMARTCD.EXE is, in
  202. files named CD999999 (where 999999 represents any number of six digits). The
  203. info is saved only when you change the disc, or when you remove the program
  204. from memory (running SMARTCD /R), so if you entered new data don't forget
  205. to remove the program before powering off the computer, or they will be lost.
  206.  
  207.  
  208. 4. Known problems
  209. -----------------
  210.  
  211.    As you know, MS-DOS isn't a multi-task environment, so it doesn't have
  212. a good support for concurrent applications. TSR programs run in background,
  213. using hardware interrupts to have the processor's attention periodically.
  214. These programs are somewhat "intruders" in the system, and may not run
  215. properly all the time.
  216.  
  217.    Actually, it's very difficult making a real good TSR program (just think
  218. of how many of them you know) and it took me some time to reach a reasonably
  219. good version (the first attempts were just a disaster!). I have tested this
  220. version intensively and it worked well, but there's no completely bug-free
  221. software, so I would suggest YOU do some testing before using this program.
  222. Try installing SMART! CD and running the applications you use more often;
  223. if your system doesn't hang up you probably won't have any other problems.
  224.  
  225.    Also, two or more TSR programs may be incompatible with each other, so
  226. if you have problems remove all unnecessary TSRs while using SMART! CD.
  227.  
  228.    While in background, SMART! CD is periodically been activated by the clock
  229. interrupt to control the CD and track programming status. This will result on
  230. a slight decrease of the machine's performance, which is normal and should not
  231. be felt by the user.
  232.  
  233.  
  234. 5. Disclaimer
  235. -------------
  236.  
  237. ******************************************************************************
  238. **  ALL WARRANTIES ARE DISCLAIMED, INCLUDING DAMAGE TO HARDWARE AND/OR      **
  239. **  SOFTWARE FROM USE OF THIS PRODUCT. THE AUTHOR WILL NOT BE LIABLE TO YOU **
  240. **  FOR ANY INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR  **
  241. **  INABILITY TO USE THE PROGRAM, OR ANY OTHER CLAIM BY ANY OTHER PARTY.    **
  242. ******************************************************************************
  243.  
  244.  
  245. 6. Distribution policy
  246. ----------------------
  247.  
  248.    SMART! CD is been distributed as SHAREWARE. Take your time to test the
  249. program, and if you decide to keep it then please pay the small registering
  250. fee, it's only $6 (yes, just six bucks!). To send your registration, print
  251. the file SMARTCD.REG.
  252.  
  253.    You can (and are encouraged to) copy the program and distribute it to
  254. anyone you want, since you take no money from it and the files SMARTCD.EXE,
  255. SMARTCD.DOC and SMARTCD.REG are distributed together, unmodified, in their
  256. uncompressed form or compressed by any popular file compressor in one single
  257. file named SMARTCD.??? (the file extension will be given by the compressor).
  258.  
  259.    If you intend to include this program in a Shareware package, you should
  260. obtain a written authorization from me (I will usually grant permission if
  261. I get a free copy of the package).
  262.  
  263.    Please see how to contact me at the very end of this file.
  264.  
  265.  
  266. 7. SMART! CD history
  267. --------------------
  268.  
  269.    Version 1.0 - 18/Apr/93
  270.                  First version. CD player basic routines and
  271.                  programming even while playing implemented.
  272.  
  273.    Version 2.0 - 28/Aug/93
  274.                  First public release.
  275.                  TSR routine implemented.
  276.                  New VGA semi-graphical display.
  277.                  Enhanced track programming, now also deletes tracks
  278.                  from the program.
  279.                  2-level repeat function implemented.
  280.  
  281. 8. Other programs by the author
  282. -------------------------------
  283.  
  284.    These are other programs by the author of SMART! CD that are worth you
  285. taking a look:
  286.  
  287.    Capture It! - Graphic screen grabber for Hercules, CGA, EGA, VGA and
  288.    (DOS)         MCGA video cards. Captures screens that other grabbers
  289.                  can't, using an exclusive timer system that saves the
  290.                  screen automatically, without user intervention via keyboard.
  291.                  Available by anonymous FTP from OAK.OAKLAND.EDU and its
  292.                  mirrors at SimTel/msdos/screen/captur22.zip.
  293.  
  294.    Cuckoo      - Cuckoo clock for Windows. Another Windows clock variation,
  295.    (WIN)         with digital sound of a real cuckoo clock!
  296.                  Available by anonymous FTP from OAK.OAKLAND.EDU and its
  297.                  mirrors at SimTel/win3/clock/cuckoo11.zip.
  298.  
  299.  
  300. 9. Contacting the author
  301. ------------------------
  302.  
  303.      Remember: SMART! CD is ShareWare, not "CrippleWare". The version you
  304. get from the Net is the fully-featured version. You're not obliged to pay
  305. the registration fee, but doing it you are motivating the author to keep
  306. writing quality programs like this one.
  307.  
  308.      Your comments, suggestions and bug reports are also welcome. Found
  309. anything strange? (this includes errors in the doc file) Please let me know!
  310.  
  311.      Write to:                          or e-mail to:
  312.  
  313.      HENRIQUE AVILA VIANNA         |
  314.      RUA ARMANDO SICA 55           |    BITNet  : HVIANNA@BRUFPEL.BITNET
  315.      96020-140 PELOTAS, RS         |    InterNet: HVIANNA@VORTEX.UFRGS.BR
  316.      BRASIL                        |
  317.  
  318.  
  319. -------------------------------> End of File <-------------------------------
  320.